home *** CD-ROM | disk | FTP | other *** search
/ SGI Performance Co-Pilot 1.3 / SGI Performance Co-Pilot 1.3.iso / dist / dist6.4 / pcp.idb / usr / share / catman / u_man / cat1 / pmgirix.z / pmgirix
Text File  |  1997-04-03  |  10KB  |  199 lines
  1.  
  2.  
  3.  
  4. PPPPMMMMGGGGIIIIRRRRIIIIXXXX((((1111))))                                                          PPPPMMMMGGGGIIIIRRRRIIIIXXXX((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppmmmmggggiiiirrrriiiixxxx - a miniature IRIX performance metrics monitor
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ppppmmmmggggiiiirrrriiiixxxx [----llll] [----ccccppppuuuuddddeeeellllttttaaaa _d_e_l_t_a] [----hhhh _h_o_s_t] [----tttt _d_e_l_t_a] [----VVVV] [_p_m_g_a_d_g_e_t_s
  13.      _o_p_t_i_o_n ...]
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      ppppmmmmggggiiiirrrriiiixxxx generates a configuration file for various IRIX performance
  17.      metrics from the Performance Co-Pilot (PCP) and feeds it to ppppmmmmggggaaaaddddggggeeeettttssss(1),
  18.      which then displays them.
  19.  
  20.      The ----ccccppppuuuuddddeeeellllttttaaaa option specifies an alternative update time for the CPU
  21.      gadget(s).  _d_e_l_t_a should be a real number of seconds.  The ----tttt option may
  22.      be used to specify an alternative update interval for the disk and
  23.      network gadgets.  The load average gadget is always updated every 5
  24.      seconds.  By default the CPU gadgets are updated every 0.25 seconds and
  25.      the disk and network gadgets use the default update interval for
  26.      ppppmmmmggggaaaaddddggggeeeettttssss.  For hosts on slow or congested networks it is advisable to
  27.      use a larger delta for the CPU gadgets and pass a larger delta through to
  28.      ppppmmmmggggaaaaddddggggeeeettttssss using ----tttt.
  29.  
  30.      The ----hhhh option specifies that ppppmmmmggggiiiirrrriiiixxxx should generate a configuration file
  31.      and run ppppmmmmggggaaaaddddggggeeeettttssss for _h_o_s_t rather than localhost.
  32.  
  33.      The display is annotated with the host name in the top left-hand corner.
  34.      The ----llll option supresses this annotation.
  35.  
  36.      The ----VVVV option causes ppppmmmmggggiiiirrrriiiixxxx to print the configuration file it generates
  37.      to standard output rather than running ppppmmmmggggaaaaddddggggeeeettttssss.  Brave individuals may
  38.      use this to customize the configuration file.
  39.  
  40.      All command line arguments except ----ccccppppuuuuddddeeeellllttttaaaa and ----VVVV are passed through to
  41.      ppppmmmmggggaaaaddddggggeeeettttssss.
  42.  
  43.      Pressing the right mouse button inside the ppppmmmmggggaaaaddddggggeeeettttssss window brings up a
  44.      popup menu which allows one to terminate ppppmmmmggggaaaaddddggggeeeettttssss.  Pressing the escape
  45.      key (Esc) with the mouse pointer in the window will also terminate the
  46.      application.  Pressing the middle mouse button over one of the gadgets in
  47.      the window will bring up a popup menu containing a list of actions for
  48.      the gadget, if appropriate.  Most gadgets with performance metrics
  49.      driving them usually have at least one action.  If there is a default
  50.      action defined for a gadget, double clicking on the gadget with the left
  51.      mouse button invokes the default action.
  52.  
  53.      Actions invoked from the popup menu under mouse button two will attempt
  54.      to obtain data from the host specified using the ----hhhh option.  For non-PCP
  55.      commands, some extra setting up may be required.   For example, the
  56.      running ttttoooopppp(1) on a remote host may involve using xxxxhhhhoooosssstttt(1) to grant that
  57.      host access to your X server and editing your .rhost file on the remote
  58.      machine to allow logins from your account on the machine running ppppmmmmggggiiiirrrriiiixxxx.
  59.      For the non-PCP commands, xxxxoooonnnn(1) is used to run text based commands (e.g.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PPPPMMMMGGGGIIIIRRRRIIIIXXXX((((1111))))                                                          PPPPMMMMGGGGIIIIRRRRIIIIXXXX((((1111))))
  71.  
  72.  
  73.  
  74.      ttttoooopppp and nnnneeeettttssssttttaaaatttt).  In other cases the tools may have their own
  75.      requirements (e.g.  ggggrrrr____oooossssvvvviiiieeeewwww).
  76.  
  77.      Gadgets that display performance metrics' values will always have an Info
  78.      action, which will create a small information window containing the names
  79.      of the metrics being displayed by the gadget along with their current
  80.      values.  This can also be displayed by positioning the mouse pointer over
  81.      a gadget and pressing the space bar.  Note that each metric specification
  82.      contains the host name.  This can be used to determine which host is
  83.      being monitored if several ppppmmmmggggaaaaddddggggeeeettttssss windows are visible.
  84.  
  85.      CPU metrics are shown as short horizontal bars (multibars) at the left
  86.      hand side of the window.  The CPUs are in groups of four, with the CPU
  87.      number increasing vertically within each group and from left to right
  88.      across the groups.  If there are more than 16 CPUs, a second line of CPU
  89.      groups is added.  The amount of time spent in user, system, interrupt,
  90.      graphics wait and idle states for each CPU is displayed by a bar.  The
  91.      Info window for a CPU bar contains the color coding and current values
  92.      for the gadget.  There are various CPU-related tools on the popup menu
  93.      under mouse button two for the CPU gadgets and their label.
  94.  
  95.      The load average is displayed as a bar graph.  The maximum is adjusted
  96.      dynamically to the highest load average seen while ppppmmmmggggaaaaddddggggeeeettttssss has been
  97.      running.  There are some load average related tools in the popup menu
  98.      under mouse button two.
  99.  
  100.      The memory bars display the amount of free memory left and the number of
  101.      pages swapped out per second over the last update interval.  The default
  102.      update interval may be changed with ppppmmmmggggaaaaddddggggeeeettttssss' ----tttt ( or ----ddddeeeellllttttaaaa) option.
  103.  
  104.      The network traffic bars on the right hand side of the window display the
  105.      number of bytes sent (orange) and received (aqua) on each of the
  106.      machine's network interfaces.  Beware, these bars are all independently
  107.      scaled according to the historical maximum number of bytes transferred
  108.      across the interface.  A steady 200 bytes in on one interface may be
  109.      indistinguishable from a steady 20K bytes in on another interface.  The
  110.      Info window for a network bar will display the numbers behind the gadgets
  111.      (the maximum is also shown).  The ----tttt ( or ----ddddeeeellllttttaaaa) option may be used to
  112.      control the update rate for the memory bars.
  113.  
  114.      The disk performance metrics are displayed as LED gadgets, one for each
  115.      disk device.  Disks on the same controller are joined together by a line.
  116.      The LEDs change colour according to how many I/O operations are performed
  117.      on the disk per second.  The Info window for each LED displays the color
  118.      coding for various levels of disk activity as well as the current figure.
  119.      As activity increases, the colour changes from green to yellow to orange
  120.      to red.
  121.  
  122. FFFFIIIILLLLEEEESSSS
  123.      ////vvvvaaaarrrr////ppppccccpppp////ppppmmmmnnnnssss////*         default PMNS specification files
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. PPPPMMMMGGGGIIIIRRRRIIIIXXXX((((1111))))                                                          PPPPMMMMGGGGIIIIRRRRIIIIXXXX((((1111))))
  137.  
  138.  
  139.  
  140. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  141.      ppppmmmmggggaaaaddddggggeeeettttssss(1), ppppmmmmcccchhhhaaaarrrrtttt(1), mmmmppppvvvviiiissss(1), ddddkkkkvvvviiiissss(1), ggggrrrr____oooossssvvvviiiieeeewwww(1), nnnneeeettttssssttttaaaatttt(1),
  142.      ttttoooopppp(1), xxxxoooonnnn(1), xxxxhhhhoooosssstttt(1), rrrrhhhhoooossssttttssss(4).
  143.  
  144. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  145.      Both ppppmmmmggggiiiirrrriiiixxxx and ppppmmmmggggaaaaddddggggeeeettttssss may produce self-explanatory error messages.
  146.      ppppmmmmggggaaaaddddggggeeeettttssss runs as an independent child process with standard output and
  147.      error directed to the terminal that ppppmmmmggggiiiirrrriiiixxxx was started from.  Error
  148.      messages and warnings from mouse button two menu actions will be sent
  149.      there.
  150.  
  151. CCCCAAAAVVVVEEEEAAAATTTTSSSS
  152.      ppppmmmmggggaaaaddddggggeeeettttssss may take a long time to start if the network link to the host
  153.      being monitored is slow or congested.  In such cases it is wise to use an
  154.      update interval of several seconds.  Both the ----ccccppppuuuuddddeeeellllttttaaaa and ----tttt options
  155.      should be specified.
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.